home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / putctl1.z / putctl1
Encoding:
Text File  |  1998-10-30  |  3.5 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ppppuuuuttttccccttttllll1111((((DDDD3333))))                                                        ppppuuuuttttccccttttllll1111((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _pppp_uuuu_tttt_cccc_tttt_llll_1111 - send a control message with a one-byte parameter to a queue
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _iiii_nnnn_tttt _pppp_uuuu_tttt_cccc_tttt_llll_1111_((((_qqqq_uuuu_eeee_uuuu_eeee______tttt _****_q_,,,, _iiii_nnnn_tttt _t_y_p_e_,,,, _iiii_nnnn_tttt _p_a_r_a_m_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _q         Pointer to the queue to which the message is to be sent.
  18.  
  19.      _t_y_p_e      Message type (must be a control type).
  20.  
  21.      _p_a_r_a_m     One-byte parameter.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      _pppp_uuuu_tttt_cccc_tttt_llll_1111, like _pppp_uuuu_tttt_cccc_tttt_llll(D3), tests the _t_y_p_e argument to make sure a data
  25.      type has not been specified, and attempts to allocate a message block.
  26.      The _p_a_r_a_m parameter can be used, for example, to specify the signal
  27.      number when an _MMMM______PPPP_CCCC_SSSS_IIII_GGGG message is being sent.  _pppp_uuuu_tttt_cccc_tttt_llll_1111 fails if _tttt_yyyy_pppp_eeee is
  28.      _MMMM______DDDD_AAAA_TTTT_AAAA, _MMMM______PPPP_RRRR_OOOO_TTTT_OOOO, or _MMMM______PPPP_CCCC_PPPP_RRRR_OOOO_TTTT_OOOO, or if a message block cannot be allocated.
  29.      If successful, _pppp_uuuu_tttt_cccc_tttt_llll_1111 calls the _pppp_uuuu_tttt(D2) routine of the queue pointed to
  30.      by _q, passing it the allocated message.
  31.  
  32.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  33.      On success, 1 is returned.  Otherwise, if _t_y_p_e is a data type, or if a
  34.      message block cannot be allocated, 0 is returned.
  35.  
  36.    LLLLeeeevvvveeeellll
  37.      Base or Interrupt.
  38.  
  39.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  40.      Does not sleep.
  41.  
  42.      Driver-defined basic locks, read/write locks, and sleep locks may not be
  43.      held across calls to this function.
  44.  
  45.    EEEExxxxaaaammmmpppplllleeeessss
  46.      See _pppp_uuuu_tttt_cccc_tttt_llll(D3) for an example of _pppp_uuuu_tttt_cccc_tttt_llll_1111.
  47.  
  48. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  49.      _pppp_uuuu_tttt(D2), _pppp_uuuu_tttt_cccc_tttt_llll(D3)
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.